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Chapitre 1 : L'appel de methodes distantes : RMI 

RMI (Remote Method Invocation) est une technologie developpee et fournie par Sun 
partir du JDK 1.1 pour permettre de mettre en oeuvre facilement des objets distribues. 

Ce chapitre contient plusieurs sections : 

• Presentation et architecture de RMI 

• Les differentes etapes pour creer un objet distant et l'appeler avec RMI 

• Le developpement cote serveur 

• Le developpement cote client 

• La generation des classes stub et Skelton 

• La mise en oeuvre des objets RMI 

• Les TPs de manipulation l’API RMI 
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1.1. Presentation et architecture de RMI 

Le but de RMI est de permettre l'appel, l'execution et le renvoi du resultat d'une 
methode executee dans une machine virtuelle differente de celle de l'objet l'appelant. 
Cette machine virtuelle peut etre sur une machine differente pourvu qu'elle soit 
accessible par le reseau. 

La machine sur laquelle s'execute la methode distante est appelee serveur. 

L'appel cote client d'une telle methode est un peu plus complique que l'appel d'une 
methode d'un objet local mais il reste simple. II consiste a obtenir une reference sur 
l'objet distant puis a simplement appeler la methode a partir de cette reference. 

La technologie RMI se charge de rendre transparente la localisation de l'objet distant, 
son appel et le renvoi du resultat. En fait, elle utilise deux classes particulieres, le stub et 
le Skelton, qui doivent etre generees avec les outils fournis avec le JDK. 

Le stub est une classe qui se situe cote client et le skeleton est son homologue cote 
serveur. Ces deux classes se chargent d'assurer tous les mecanismes d'appel, de 
communication, d'execution, de renvoie et de reception du resultat. 

1.2. Les differentes etapes pour creer un objet distant et l'appeler avec RMI 

Le developpement cote serveur se compose de : 

• La definition d'une interface qui contient les methodes qui peuvent etre appelees 
a distance 

• L'ecriture d'une classe qui implemente cette interface 

• L'ecriture d'une classe qui instanciera l'objet et l'enregistrera en lui affectant un 
nom dans le registre de nom RMI (RMI Registry) 



Le developpement cote client se compose de : 

• L'obtention d'une reference sur l'objet distant a partir de son nom 

• L'appel a la methode a partir de cette reference 



1.3. Le developpement cote serveur 

1.3.1. La definition d'une interface qui contient les methodes de l'objet distant 

L'interface a definir doit heriter de l'interface java.rmi. Remote. Cette interface ne 
contient aucune methode mais indique simplement que l'interface peut etre appelee a 
distance. 
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L'interface doit contenir toutes les methodes qui seront susceptibles d'etre appelees a 
distance. 

La communication entre le client et le serveur lors de l'invocation de la methode 
distante peut echouer pour diverses raisons comme un crash du serveur, une rupture de 
la liaison, etc ... 

Ainsi chaque methode appelee a distance doit declarer qu'elle est en mesure de lever 
l'exception java.rmi.RemoteException. 



package test_rmi,- 
import j ava . rmi . * ; 

public interface Information extends Remote { 

public String get Informat ion ( ) throws RemoteException; 

} 



1.3.2. L'ecriture d'une classe qui implemente cette interface 

Cette classe correspond a l'objet distant. Elle doit done implementer l'interface definie et 
contenir le code necessaire. 

Cette classe doit obligatoirement heriter de la classe UnicastRemoteObject qui contient 
les differents traitements elementaires pour un objet distant dont l'appel par le stub du 
client est unique. Le stub ne peut obtenir qu'une seule reference sur un objet distant 
heritant de UnicastRemoteObject. On peut supposer qu'une future version de RMI sera 
Capable de faire du Multicast, permettant a RMI de choisir parmi plusieurs objets 
distants identiques la reference a fournir au client. 

La hierarchie de la classe UnicastRemoteObject est : 



java.lang.Object 

java.rmi.Server.RemoteObject 

java.rmi.Server.RemoteServer 

java.rmi.Server.UnicastRemoteObject 



Comme indique dans l'interface, toutes les methodes distantes doivent indiquer qu'elles 
peuvent lever l'exception RemoteException mais aussi le constructeur de la classe. Ainsi, 
meme si le constructeur ne contient pas de code il doit etre redefini pour inhiber la 
generation du constructeur par defaut qui ne leve pas cette exception. 
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package test_rmi; 
import j ava . rmi . * ; 
import j ava . rmi . server . * ; 

public class TestRMIServer extends UnicastRemoteObject implements Information { 

protected TestRMIServer ( ) throws Remot|e Except ion { 
super ( ) ; 

} 

public String get Informat ion () throws RemoteException { 
return "bonjour"; 

} 



1.3.3. L'ecriture d'une classe pour instancier l'objet et l'enregistrer dans le 
registre 

Ces operations peuvent etre effectuees dans la methode main d'une classe dediee ou 
dans la methode main de la classe de l'objet distant. L'interet d'une classe dedie et 
qu'elle permet de regrouper toutes ces operations pour un ensemble d'objets distants. 

La marche a suivre contient trois etapes : 

• La mise en place d'un Security manager dedie qui est facultative 

• L'instanciation d'un objet de la classe distante 

• L'enregistrement de la classe dans le registre de nom RMI en lui donnant un nom 

1.3.4. L'enregistrement dans le registre de nom RMI en lui donnant un nom 

La derniere operation consiste a enregistrer l'objet cree dans le registre de nom en lui 
affectant un nom. Ce nom est fourni au registre sous forme d'une URL constitue du 
prefix rmi://, du nom du seveur (hostname) et du nom associe a l'objet precede d'un 
slash. 

Le nom du serveur peut etre fourni « en dur » sous forme d'une constante chaine de 
caracteres ou peut etre dynamiquement obtenu en utilisant la classe InetAddress pour 
une utilisation en locale. 

C'est ce nom qui sera utilise dans une URL par le client pour obtenir une reference sur 
l'objet distant. 

L'enregistrement se fait en utilisant la methode rebind de la classe Naming. Elle attend 
en parametre l'URL du nom de l'objet et l'objet lui meme. 
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public static void main(String[] args) { 
try { 

System. out .println { "Mise en place du Security Manager ..."); 
System. setSecurityManager (new j ava . rmi . RMISecurityManager () ) ; 

TestRMIServer testRMIServer = new TestRMIServer () ; 

System. out .println ( "Enregistrement du serveur" ) ; 

Naming . rebind ( "rmi : / /"+ java .net . Inet Address . getLocalHost ( ) + 
"/TestRMI" , testRMIServer) ; 

// Naming. rebind ("; rmi ://localhost/TestRMI " , testRMIServer); 
System. out. println ( "Serveur lance") ; 

} catch (Exception e) { 

System. out. println ("Exception capturee: " + e.getMessage() ) ; 

} 

} 



1.3.5. Lancement dynamique du registre de nom RMI 

Sur le serveur, le registre de nom RMI doit s'executer avant de pouvoir enregistrer un 
objet ou obtenir une reference. 

Ce registre peut etre lance en tant qu'application fournie par sun dans le JDK 
(rmiregistry) ou peut etre lance dynamiquement dans la classe qui enregistre l'objet. Ce 
lancement ne doit avoir lieu qu'une seule et unique fois. II peut etre interessant d'utiliser 
ce code si Ton cree une classe dedie a l'enregistrement des objets distants. 

Le code pour executer le registre est la methode createRegistry de la classe 
ava.rmi.registry.LocateRegistry. Cette methode attend en parametre un num ero de port. 

public static void main (String [] args) { 

try { 

j ava . rmi . registry . LocateRegistry. createRegistry (1099) ; 

System. out .println( "Mise en place du Security Manager ..."),- 
System. setSecurityManager (new j ava. rmi. RMISecurityManager () ) ; 



} 

} 



1.4. Le developpement cote client 

1.4.1. La mise en place d'un Security Manager 
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Comme pour le cote serveur, cette operation est facultative. 

Le choix de la mise en place d'un Security manager cote client suit des regies identiques 
a celui du cote serveur. Sans son utilisation, il est necessaire de mettre dans le 
CLASSPATH du client toutes les classes necessaires dont la classe stub. 



public static void main (String!] args) { 

System. setSecurityManager (new RMISecurityManager;) ) ; 

} 



1.4.2. L'obtention d'une reference sur l'objet distant a partir de son nom 

Pour obtenir une reference sur l'objet distant a partir de son nom, il faut utiliser la 
methode statique lookup() de la classe Naming. 

Cette methode attend en parametre une URL indiquant le nom qui reference l'objet 
distant. Cette URL est compose de prefix rmi://, le nom du serveur (hostname) et le nom 
de l'objet tel qu'il a ete enregistre dans le registre precede d'un slash. 

Il est preferable de prevoir le nom du serveur sous forme de parametres de l'application 
ou de l'applet pour plus de souplesse. 

La methode lookup() va rechercher dans le registre du serveur l'objet et retourner un 
objet stub. L'objet retourne est de la classe Remote (cette classe est la classe mere de 
tous les objets distants). 

Si le nom fourni dans l'URL n'est pas reference dans le registre, la methode leve 
l'exception NotBoundException. 



public static void main (String!] args) { 

System. setSecurityManager (new RMISecurityManager ( ) ) ; 
try { 

Remote r = Naming. lookup!" rmi : //vaio/127. 0. 0.1/TestRMI" ) ; 

} catch (Exception e) { 

} 

} 



1.4.3. L'appel a la methode a partir de la reference sur l'objet distant 

L'objet retourne etant de type Remote, il faut realiser un cast vers l'interface qui definit 
les methodes de l'objet distant. 
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Pour plus de securite, on verifie que l'objet retourne est bien une instance de cette 
interface. Un fois le cast realise, il suffit simplement d'appeler la methode. 



public static void main (String!] args) { 

System. setSecurityManager (new RMISecurityManager ( ) ) ; 
try { 

Remote r = Naming, lookup ( "rmi .- //vaio/127 . 0 . 0 . 1/TestRMI ") ; 

if (r instanceof Information) { 

String s = ((Information) r) .get Informat ion () ; 

System. out .println{"chaine renvoyee = " + s) ; 

} 

} catch (Exception e) { 

} 



1.4.4. L'appel d'une methode distante dans une applet 

L'appel d'une methode distante est la meme dans une application et dans une applet. 
Seule la mise en place d'un Security Manager dedie dans les applets est inutile car elles 
utilisent deja un Security Manager (AppletSecurityManager) qui autorise le chargement 
de classes distantes. 

public void init() { 

try 1 

Remote r = Naming . lookup ( "rmi : //vaio/127 . 0. 0 . 1/TestRMI" ) ,- 

if (r instanceof Information) { 

s = ((Information) r) .get Informat ion <) ; 

} 

} catch (Exception e) { 

} 

} 



1.5. La mise en ceuvre des objets RMI 

La mise en oeuvre et l'utilisation d'objet distant avec RMI necessite plusieurs etapes : 

1. Demarrer le registre RMI sur le serveur soit en utilisant le programme 
rmiregistry livre avec le JDK soit en executant une classe qui effectue le 
lancement. 

2. Executer la classe qui instancie l'objet distant et l'enregistre dans le serveur de 
nom RMI 

3. Lancer l'application ou l'applet pour tester. 
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1.6. Les TP de manipulation de I’ API RMI 

Dans cet atelier, nous traiterons le cas de la recharge d’un telephone mobile a partir du 
guichet bancaire automatique. 



41P 




Operateurs 


r; [mim 


Ligne specialise/VPN 


Guichet bancaire (Banque 
A) 


Operateur Telecom 



Pour recharger son telephone mobile a partir d’un guichet bancaire, le client doit saisir 
le numero de telephone et le montant de la recharge a utiliser. 

Nous aurons besoin de creer deux classes 

Supposons alors qu’une facture est definie par son numero et son client. 

1.6.1 Le fournisseur du service de recharge 

Les elements a implementer et les etapes a mettre en oeuvre dans la plateforme du 
fournisseur sont detailles comme suivant : 



1. Creer un projet « II-OperateurTelecom » et creer le package modele 
« ma.operateur.telecom.model » 

2. Dans le package modele « ma.operateur.telecom.model », creer deux classes 
Client et Recharge. 

3. La classe client est defini par l'attribut numTelephone de type chaine de 
caracteres. Generer automatiquement les Getters et les Setters de cet attribut. 
Surcharger le constructeur de cette classe automatiquement. 



public class Client { 

private String numTelephone; 
public String getNumTelephone ( ) { 

return numTelephone; 

} 

public void setNumTelephone ( String numTelephone) { 
this . numTelephone = numTelephone; 

} 

public Client ( String numTelephone) { 
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super ( ) ; 

this . numTelephone = numTelephone; 

} 

} 

4. La classe Recharge est definie par l'attribut clientRecharge de type Client, et 
montantRecharge de type double. Generer automatiquement les Getters et les 
Setters de ces attributs. Surcharger le constructeur de cette classe 
automatiquement. 

public class Recharge { 

private Client clientRecharge; 
private double montantRecharge; 

public Recharge (Client clientRecharge, double montantRecharge) { 

super ( ) ; 

this . clientRecharge = clientRecharge; 
this . montantRecharge = montantRecharge; 

} 

public Client getClientRecharge ( ) { 

return clientRecharge; 

} 

public void setClientRecharge (Client clientRecharge) { 
this . clientRecharge = clientRecharge; 

} 

public double getMontantRecharge ( ) { 

return montantRecharge; 

} 

public void setMontantRecharge (double montantRecharge) { 
this . montantRecharge = montantRecharge; 

} 

} 



5. Maintenant, nous allons creer un package pour les services a exposer par 
l'operateur Telecom. Appeler le « ma.operateur.telecom.services » 

6. Dans le package « ma.operateur.telecom.services », creer une interface 
IOperateurTelecomServices. 
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Cette interface sera consideree comme un contrat entre le fournisseur 
(L'operateur Telecom) et le client (La banque) de notre service de 
recharge. 

7. Dans le contrat cree, mettre la signature de la methode qui permet de recharger 
le solde. Cette methode prend en parametre un objet de type Recharge et 
retourne un boolean. 

package ma . operateur .telecom . services ; 
import ma . operateur . telecom . model . Recharge ; 
public interface IOperateurTelecomServices { 

public boolean rechargerSolde (Recharge recharge); 

} 




8. Le contrat cr ee, doit respecter les regies exigees par le RMI. 

• Le contrat doit etendre Tinterface java.rmi.Remote 

• Les services exposes en RMI doivent remonter des exceptions de 

types java.rmi.RemoteException 




9. Ajouter le lien d’heritage avec java.rmi.Remote et remonter les exceptions 
java.rmi.RemoteException. 

package ma . operateur . telecom . services ; 

import java.rmi.Remote; 

import java . rmi . RemoteException; 

import ma . operateur . telecom . model . Recharge ; 

public interface IOperateurTelecomServices extends Remote { 

public boolean rechargerSolde (Recharge recharge) throws 
RemoteException; 

} 



10. Maintenant creer la classe OperateurTelecomServicesImpl qui implemente 
l'interface IOperateurTelecomServices dans le package 

« ma. operateur .telecom.services ». Dans ^implementation de la methode 
rechargeSolde, faire une trace pour s’assurer de l’execution de cette methode lors 
de l'invocation d'une banque. 

package ma . operateur . telecom . services ; 

import java . rmi . RemoteException; 

import ma . operateur . telecom. model . Recharge ; 

public class OperateurTelecomServicesImpl implements 
IOperateurTelecomServices { 

SOverride 
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public boolean rechargerSolde (Recharge recharge) throws 
RemoteException { 

System . out . println ( "Une banque a fait 1' invocation de cette 

methode" ) ; 

return false; 

} 

} 



1 1. La classe qui implemente le contrat, doit respecter les regies exigees par le RM I 




L' implementation du contrat RMI doit etendre la classe 
java.rml.server.UnicastObjectRemote 



12. Ajouter le lien d’heritage entre OperateurTelecomServicesImpl et 
UnicastRemoteObjet. Une erreur de compilation apparaitra alors dans votre 
programme et elle est justifiee par le fait que le constructeur de la classe 
UnicastRemoteObjet remonte des exceptions de type RemoteException. Dans le 
constructeur de la classe OperateurTelecomServicesImpl Remonter egalement 
des exceptions de type RemoteException pour corriger cette erreur de 
compilation. 

package ma . operateur . telecom . services ; 
import java . rmi . RemoteException; 
import java . rmi . server . UnicastRemoteOb ject ; 
import ma . operateur . telecom. model . Recharge ; 

public class OperateurTelecomServicesImpl extends UnicastRemoteOb ject 
implements IOperateurTelecomServices { 



protected OperateurTelecomServicesImpl ( ) throws RemoteException { 

super ( ) ; 

// TODO Auto-generated constructor stub 



SOverride 

public boolean rechargerSolde (Recharge recharge) throws 
RemoteException { 

System . out . println ( "Une banque a fait 1' invocation de cette 

methode" ) ; 

return false; 
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13. Apres avoir implements les trois regies exigees par le RMI, nous allons creer un 
serveur RMI qui va attendre les demandes qui vont parvenir des banques. II s’agit 
d’une classe java contenant la methode main. Elle contiendra les trois 
instructions suivantes : 

a . Reserver un port RMI pour etre a l'ecoute. 

LocateRegistry . createRegistry (1099) ; 



b. Instancier a place de la banque un objet de la classe 
OperateurTelecomServicesImpl. La banque ne peut pas instancier cet objet car 
elle n’aura pas la classe OperateurTelecomServicesImpl qui contient le code de la 
meth ode de recharge fc'est une methode hyper sensible) 

IOperateurTelecomServices contrat = new 
OperateurTelecomServicesImpl () ; 



c. Associer a l'objet cree dans le point (b) une URL RMI. 

Naming . bind ( "rmi : //localhost : 10 99/test " , contrat) ; 



14. Dans le package « ma.operateur.telecom.services », creer une classe ServerRMI 
contenant la methode main avec les trois instructions cites dans le point 
precedent. 



package ma . operateur .telecom . services ; 
import java . net . Malf ormedURLException; 
import java . rmi . AlreadyBoundException; 
import java . rmi . Naming; 
import java . rmi . RemoteException; 
import java . rmi . registry . LocateRegistry; 
public class ServerRMI { 

I ~k 

* @param args 
*/ 

public static void main ( String [ ] args) { 

try { 

LocateRegistry . createRegistry (1099) ; 

IOperateurTelecomServices contrat = new 
OperateurTelecomServicesImpl () ; 

Naming . bind ( " rmi : / /localhost : 1099/test", contrat ) ; 

System . out . println (" Serveur RMI en attente"); 
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} catch (RemoteException e) { 

// TODO Auto-generated catch block 
e .printStackTrace ( ) ; 

} catch (Malf ormedURLException e) { 

// TODO Auto-generated catch block 
e .printStackTrace ( ) ; 

} catch (AlreadyBoundException e) { 

// TODO Auto-generated catch block 
e .printStackTrace ( ) ; 

} 

} 

} 

• L'URL RMI doit respecter la forme exigee par le RMI suivante 

rmi://server :port/nomObjet 




15. Faire l'execution de la classe ServerRMI et s’assurer qu’elle reste en attente. 



* Problems @ Javadoc [^.Declaration S Console S3 Servers /& Search § TCP/IP Monitor 


■ 




ServerRMI [Java Application] E:\Program Files\Java\jrel .6. 0_03\bin\javaw.exe (22 oct. 2012 23:25:03) ^ 






Serveur RMI en attente 


SERVER EN ATTENTE 





1.6.2 Le client du service de recharge (La banque) 

Le fournisseur d’un service doit donner a son client les classes modeles (les classe Client 
et Recharge) etle contrat du service (l'interface IOperateurTelecomServices). 




Le client d'un service doit disposer des classes modeles et du 
contrat du service 



16. Creer un nouveau projet et appeler le « II-GuichetBancaire ». Copier dans ce 
projet les classes modeles et le contrat a partir du projet « II-OperateurTelecom ». 
II faut respecter les memes packages 
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S lc7 II-GuichetBancaire 
B src 

a ffi ma . operateur . telecom . model 
S3 0 Client. java 
SI Qj Recharge. java 
a » ma . operateur .telecom . services 
SI [ 7 ] IOperateurTelecomServices.java 
SI Wti JRE System Library [jrel.6.0_03] 

i - i 



17. Creer ensuite un package « ma.gb. presentation » dans le projet « II- 
GuichetBancaire ». Puis une classe InvoquerServicesOperateur contenant la 
methode main. 

18. Dans la methode main : de la classe InvoquerServicesOperateur, rechercher 

l'objet des services auquel le fournisseur a attribue l’url RMI suivante : 
rmi://localhost :1099/test 

IOperateurTelecomServices contrat = ( IOperateurTelecomServices ) 

Naming . lookup ( " rmi : //localhost : 10 99/test " ) ; 



19. Dans la methode main : Instancier un objet de type client puis un objet de type 
Recharge. 

Client clientRecharge = new Client ( "0660980989" ) ; 

Recharge recharge = new Recharge (clientRecharge, 50.00d); 



20. Dans la methode main : Invoquer la methode rechargerSolde en passant l’objet 
recharge comme argument. Tracer ensuite le retour du service de recharge 

boolean resultatRecharge = contrat . rechargerSolde (recharge) ; 

System . out. print In (resultatRecharge) ; 



21. Dans la methode main : Invoquer la methode rechargerSolde en passant l’objet 
recharge comme argument. Tracer ensuite le retour du service de recharge 

boolean resultatRecharge = contrat . rechargerSolde (recharge) ; 

System . out. print In (resultatRecharge) ; 



22. Faire l'execution de la classe InvoquerServicesOperateur et remarquer 
l'exception par rapport aux classes Client et Recharge qui ne sont pas 
serialisables. 

java . rmi .MarshalException : error marshalling arguments; nested exception is: 
java . io . NotSerializableException : ma . operateur . telecom. model . Recharge 
at sun . rmi . server . UnicastRef . invoke (Unknown Source) 

at java . rmi . server . RemoteOb jectlnvocationHandler . invokeRemoteMethod (Unknown Source) 
at java . rmi . server . RemoteOb jectlnvocationHandler . invoke (Unknown Source) 
at $Proxy0 . rechargerSolde (Unknown Source) 

at ma . gb .presentation . InvoquerServicesOperateur .main ( InvoquerServicesOperateur. java: 20 ) 
Caused by: java . io . NotSerializableException : ma . operateur . telecom. model .Recharge 
at java . io .Ob jectOutputStream. writeOb jectO (Unknown Source) 
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at java . io .Ob jectOutputStream. writeOb ject (Unknown Source) 
at sun . rmi . server .UnicastRef .marshalValue (Unknown Source) 
... 5 more 



23. Ajouter l’implementation de java.io. Serializable pour les classes Client et 
Recharge cote fournisseur et cote client. Redemarrer le serveur RMI et essayer 

d'invoquer le service de recharge a nouveau 

• Le client d'un service ne doit jamais avoir acces a la classe 
d'implementation. Dans notre cas la banque ne devra jamais 
avoir la classe Ope r ateurTe lecomServ ices Imp 1 
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Chapitre 2 : La serialisation binaire des obiets 



La serialisation est un procede introduit dans le JDK version 1.1 qui permet de rendre un 
objet persistant. Cet objet est mis sous une forme sous laquelle il pourra etre reconstitue 
a l'identique. Ainsi il pourra etre stocke sur un disque dur ou transmis au travers d'un 
reseau pour le creer dans une autre JVM. C'est le procede qui est utilise par RMI. La 
serialisation est aussi utilisee par les beans pour sauvegarder leurs etats. 

Au travers de ce mecanisme, java fourni une fafon facile, transparente et standard de 
realiser cette operation : ceci permet de facilement mettre en place un mecanisme de 
persistance. Il est de ce fait inutile de creer un format particulier pour sauvegarder et 
relire un objet. Le format utilise est independant du systeme d'exploitation. Ainsi, un 
objet serialise sur un systeme peut etre reutilise par un autre systeme pour recreer 
l'objet. 

L'ajout d'un attribut a l'objet est automatiquement pris en compte lors de la 
serialisation. Attention toutefois, la deserialisation de l'objet doit se faire avec la classe 
qui a ete utilisee pour la serialisation. La serialisation peut s'appliquer facilement a tous 
les objets. 

Ce chapitre presente dans plusieurs sections l'utilisation de cette API 

• Presentation des classes de la serialisation binaire 

• Le mot reserve transient 

• La relation « avoir a » et la serialisation binaire 

• Les Tps de manipulation de la serialisation binaire 
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2.1. Les classes et les interfaces de la serialisation 

La serialisation definie l'interface Serializable et les classes ObjectOutputStream et 
Obj ectlnputStream 

2.1.1. L'interface Serializable 

Cette interface ne definie aucune methode mais permet simplement de marquer une 
classe comme pouvant etre serialisee. 

Tout objet qui doit etre serialiser doit implementer cette interface ou une de ses classes 
meres doit l'implementer. 

Si Ton tente de serialiser un objet qui n'implemente pas l'interface Serializable, une 
exception NotSerializableException est levee. 



public class Personne implements java . io . Serializable { 

private String nom = 
private String prenom = 
private int taille = 0; 

public Personne (String nom. String prenom, int taille) { 
this. nom = nom; 
this. taille = taille; 
this. prenom = prenom; 

} 

public String getNom() { 
return nom; 

} 

public void setNom (String nom) { 
this. nom = nom; 

} 

public int getTailleO { 
return taille; 

} 

public void setTaille ( int taille) { 
this. taille = taille; 

} 

public String getPrenom() { 
return prenom; 

} 

public void setPrenom (String prenom) { 
this. prenom = prenom; 

} 

} 



2.1.2. La classe ObjectOuputStream 



Cette classe permet de serialiser un objet. 
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import java.io.*; 

public class SerializerPersonne { 
public static void main (String argv [ ] ) { 

Personne personne = new Personne ( "Dupond" , " Jean" , 17 5 ) ; 
try { 

FileOutputStream fichier = new 
FileOutputStream ( "personne . ser" ) ; 

Ob jectOutputStream oos = new Ob jectOutputStream ( fichier) ; 
oos . writeOb ject (personne) ; 
oos . flush ( ) ; 
oos . close ( ) ; 

} 

catch ( java . io . IOException e) { 
e . printStackTrace () ; 

} 

} 

} 



On definit un fichier avec la classe FileOutputStream. On instancie un objet de classe 
ObjectOutputStream en lui fournissant en parametre le fichier : ainsi, le resultat de la 
serialisation sera envoye dans le fichier. 

On appel la methode writeObject en lui passant en parametre l'objet a serialiser. On 
appelle la methode flush() pour vider le tampon dans le fichier et la methode closef) 
pour terminer l'operation. 

Lors de ces operations une exception de type IOException peut etre levee si un probleme 
intervient avec le fichier. 

Apres l'execution de cet exemple, un fichier nomme « personne. ser » est cree. On peut 
visualiser sont contenu mais surtout pas le modifier car sinon il serait corrompu. En 
effet, les donnees contenues dans ce fichier ne sont pas toutes au format caracteres. 

La classe ObjectOutputStream contient aussi plusieurs methodes qui permettent de 
serialiser des types elementaires et non des objets : writelnt, writeDouble, writeFloat ... 

II est possible dans un meme flux d'ecrire plusieurs objets les uns a la suite des autres. 
Ainsi plusieurs objets peuvent etre sauvegardes. Dans ce cas, il faut faire attention de 
relire les objets dans leur ordre d'ecriture. 

2.1.3. La classe ObjectlnputStream 

Cette classe permet de desserialiser un objet. 



import java.io.*; 

public class DeSerializerPersonne { 
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public static void main (String argv [ ] ) { 

try { 

FilelnputStream fichier = new FilelnputStream ( "personne . ser " ) ; 
Ob ject InputStream ois = new Ob ject InputStream ( fichier ) ; 
Personne personne = (Personne) ois . readOb ject () ; 

System . out . print in ( "Personne : "); 

System . out . print in ( "nom : "+personne . getNom ( ) ) ; 

System . out . print in ( "prenom : "+personne . getPrenom ( ) ) ; 

System . out . print in ( "taille : "+personne . getTaille ( ) ) ; 

} 

catch ( java . io . IOException e) { 
e . printStackTrace () ; 

} 

catch (ClassNotFoundExcept ion e) { 
e . printStackTrace () ; 

} 

} 

} 



Resultat : 



C:\dej>java DeSerializerPersonne 

Personne : 

nom : Dupond 

prenom : Jean 

taille : 175 



On creer un objet de la classe FilelnputStream qui represente le fichier contenant l'objet 
serialise. On creer un objet de type ObjectlnputStream en lui passant le fichier en 
parametre. Un appele a la methode readObject() retourne l'objet avec un type Object. Un 
cast est necessaire pour obtenir le type de l'objet. La methode close() permet de 
terminer l'operation. 

Si la classe a changee entre le moment ou elle a ete serialisee et le moment ou elle est 
deserialisee, une exception est levee : 



Exemple : la classe Personne est modifiee et recompilee 
C : \temp> java DeSerializerPersonne 

java . io . InvalidClassException : Personne; Local class not compatible: stream class 
desc serialVersionUID=-273 966917 84 69387 642 local class serialVersionUID=39870587 
36962107851 

at java . io . Ob jectStreamClass . validateLocalClass (Ob jectStreamClass . java : 4 
38) 

at java . io . Ob jectStreamClass .setClass (Ob jectStreamClass . java : 4 82 ) 
at java . io . ObjectlnputStream. input ClassDe script or (ObjectlnputStream . java 
: 785) 

at java . io . ObjectlnputStream. readOb ject (ObjectlnputStream . java : 353 ) 
at java . io . ObjectlnputStream. readOb ject (ObjectlnputStream . java : 232 ) 
at java . io . ObjectlnputStream. input Ob ject (ObjectlnputStream . java : 978 ) 
at java . io . ObjectlnputStream. readOb ject (ObjectlnputStream . java : 3 69) 
at java . io . ObjectlnputStream. readOb ject (ObjectlnputStream . java : 232 ) 
at DeSerializerPersonne . main (DeSerializerPersonne . java : 9) 
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La classe ObjectlnputStream possede de la meme fagon que la classe 
ObjectOutputStream des methodes pour lire des donnees de type primitives : readlnt(), 
readDoublef), readFloat ... 

Lors de la deserialisation, le constructeur de l'objetn'est jamais utilise. 

2.1.4. Le mot cle transient 

Le contenu des attributs sont visibles dans le flux dans lequel est serialise l'objet. II est 
ainsi possible pour toute personne ayant acces au flux de voir le contenu de chaque 
attribut meme si ceux si sont private. Ceci peut poser des problemes de securite surtout 
si les donnees sont sensibles. 

Java introduit le mot cle transient qui precise que l'attribut qu'il qualifie ne doit pas etre 
inclus dans un processus de serialisation et done de deserialisation. 



private transient String codeSecret; 



Lors de la deserialisation, les champs transient sont initialises avec la valeur null. Ceci 
peut poser des problemes a l'objet qui doit gerer cette etat pour eviter d'avoir des 
exceptions de type NullPointerException. 

2.2. Les TP de manipulation de la serialisation binaire 

La serialisation convertit (sauvegarde) les valeurs stockees dans les attributs d'un objet 
en flux de donnees (fichiers). 

-Si les fichiers generes par une serialisation sont binaires, on parle d’une 
serialisation binaire. 

-Si les fichiers generes par une serialisation sont en XML, on parle d’une 
serialisation XML. 

La serialisation prend son sens dans une communication distribute (invocation d’une 
methode distante). Dans ce cas les objets serialises sont : 

Les objets a passer en arguments pour invoquer la methode distante. 

L’objet qui sera retourne par la methode distante. 



La deserialisation est l’operation inverse de la serialisation. Elle convertit un flux de 
donnees en objets. 



Objets ► 


Serialisation des objets 


►Fichiers 


Fichiers ► 


Deserialisation des fichiers 


► Objets 



Une classe est dite serialisable lorsqu’elle implemente l’interface java.io. Serializable. 
Dans la suite de cet atelier, nous traiterons le cas du reglement d’une facture d’un 
telephone mobile a partir du guichet bancaire automatique (La banque A a titre 
d’exemple). 



21/44 







JA VA A VANCE : RMI JDBC SERI ALISA TION INI 




1 ; o 



Guichet bancaire (Banque 
A) 



ugne specianse/vm > 



Operateurs 



Operateur Telecom 



Pour regler sa facture, le client doit saisir le numero de telephone relatif a la facture et il 
doit choisir la facture a regler. Supposons alors qu’une facture est definie par son 
numero et son client. 

2.2.1 Serialisation binaire des objets de la classe Facture. 

La serialisation des objets de la classe Facture se fait cote guichet bancaire, car c'est a ce 
niveau que l’operation de reglement est declenchee. 

1. Creer un projet « Guichet Bancaire » et un package 
« ma.reglement.factures.model» 

2. Dans le package « ma.reglement.factures.model» : 

• Creer une classe Client ayant l’attribut numTelephone de type chaine de 
caracteres. 

• Generer automatiquement les Getters et les Setters de l'attribut 
numTelephone. 

• Surcharger automatiquement le constructeur de la classe Client par 
l’attribut numTelephone. 



package ma . reglement . factures . model ; 
public class Client { 

private String numTelephone; 

public String getNumTelephone ( ) { 

return numTelephone; 

} 

public void setNumTelephone (String numTelephone) { 
this . numTelephone = numTelephone; 

} 

public Client ( String numTelephone) { 

this . numTelephone = numTelephone; 

} 
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} 

3. Dans le package « ma.reglement.factures.model» : 

• Creer une classe Facture ayant les deux attributs numFacture de type 
chaine de caracteres et clientFacture de type Client 

• Generer automatiquement les Getters et les Setters des deux attributs 
numFacture et clientFacture de la classe Facture 

• Surcharger automatiquement le constructeur de la classe Facture par les 

deux attributs numFacture et clientFacture. 

package ma . reglement . f actures .model ; 
public class Facture { 

private String numFacture; 
private Client clientFacture; 
public String getNumFacture ( ) { 

return numFacture; 

} 

public void setNumFacture ( String numFacture) { 
this . numFacture = numFacture; 

} 

public Client getClientFacture ( ) { 

return clientFacture; 

} 

public Facture ( String numFacture, Client clientFacture) { 

super ( ) ; 

this . numFacture = numFacture; 
this . clientFacture = clientFacture; 

} 

public void setClientFacture (Client clientFacture) { 
this . clientFacture = clientFacture; 

} 

} 



4. Creer un autre package « ma.reglement.factures.main» 
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5. Dans le package « ma.reglement.factures.main» : 

• Creer une classe SerialisationDuGuichet contenant la methode main du 
Java. 

• Dans la methode main, creer le code Java pour serialiser les objets de la 

classe Facture. 

package ma . reglement . factures .main; 
import java . io . FileNotFoundException ; 
import java . io . FileOutputStream; 
import java . io . IOExcept ion; 
import java . io . Ob jectOutputStream; 
import ma . reglement . factures .model . Client ; 
import ma . reglement . factures .model .Facture; 
public class SerialisationDuGuichet { 
public static void main (String [ ] args) { 
try { 

Client client = new Client (" 0 66150322 8 ") ; 

Facture facture = new Facture ( "FAC0001 " , client); 

FileOutputStream fos = new 

FileOutputStream ( "c : /test . txt " ) ; 

Ob jectOutputStream os = new Ob jectOutputStream (fos) ; 

os . writeOb ject (facture ) ; 

} catch (FileNotFoundException e) { 

e . printStackTrace ( ) ; 

} catch (IOException e) { 

e . printStackTrace ( ) ; 

} 

} } 

Lors de la serialisation des objets, le developpeur doit gerer les deux 
exceptions suivantes : FileNotFoundException et IOException 

6. Faire l'execution du programme de la serialisation de l’objet Facture. Remarquer 
l'exception signalant que les objets de la classe Facture ne sont pas serialisables. 
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java . io . NotSerializableException : ma . reglement . factures .model . Facture 
at java . io . Ob jectOutputStream. writeOb jectO (Unknown Source) 
at java . io . Ob jectOutputStream. writeOb ject (Unknown Source) 
at 

ma . reglement . factures .main . SerialisationDuGuichet .main ( Serial is at ionD 
uGuichet . java : 22 ) 



Seuls ies objets des classes qui implementent I'interface 
java. io. Serializable peuvent etre sauvegardes sous de forme de fichiers. 



7. Aj outer le lien d’implementation entre la classe Facture et I'interface 
java.io. Serializable et refaire l’execution du programme de la serialisation. 
Remarque que l’exception java.io. NotSerializableException persiste toujours mais 
cette fois c'est par rapport a la classe Client. 

La classe Facture apres ajout de implements Serializable 

package ma . reglement . factures . model ; 
import java . io . Serializable; 

public class Facture implements Serializable { 

//Contenu de la classe Facture 

} 

L'exception apres execution du programme de la serialisation. 

java . io . NotSerializableException : ma . reglement . factures .model . Client 

at java . io . Ob jectOutputStream. writeOb jectO (Unknown Source) 

at java . io . Ob jectOutputStream. def aultWriteFields (Unknown 

Source) 

at java . io . Ob jectOutputStream. writeSerialData (Unknown Source) 

at java . io . Ob jectOutputStream. writeOrdinaryOb ject (Unknown 

Source) 

at java . io . Ob jectOutputStream. writeOb jectO (Unknown Source) 
at java . io . Ob jectOutputStream. writeOb ject (Unknown Source) 
at 

ma . reglement . factures .main . SerialisationDuGuichet .main ( SerialisationD 
uGuichet . java : 22 ) 
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Pour serialiser un objet, il faut que sa classe implemente I'interface 
java. io. Serializable et que toutes les classes de ses attributs 
implemented egalement I'interface java. io. Serializable 



8. Maintenant ajouter le lien ^implementation entre la classe Client et I'interface 
java.io. Serializable et refaire l'execution du programme de la serialisation. 
Remarquer que l’exception java.io. NotSerializableException ne persiste plus et 
qu'un fichier est genere dans votre disque dur. 



Adresse uiC:\ 



Gestion des fichiers 

|i Creer un nouveau dossier - t Publier ce dossier sur le Web || Partager ce dossier 




SwSetup 




log2.txt 
Document texts 
1Kb 




test, bet 

Document texte 
1Kb 



2.2.2 Serialisation binaire et la relation « avoir a » 

Une classe A est en relation « avoir a » avec une autre classe B si parmi les attributs de la 
classe A on trouve un attribut de type la classe B. (Dans notre exemple la classe Facture est en 
relation « Avoir a » avec la classe Client) 

Nous allons etudier les differents cas relatifs a la serialisation des objets de la classe 
Facture sous l'implication suivante : 

Serialiser l’objet Facture □ □ i [ ^Serialiser l’objet Client 



2.2.2.1 : Le developpeur a acces a la classe Client 

Le developpeur de la classe Facture a Vacces a la source de la classe Client 
(Client.java). La solution consiste dans ce cas a s’assurer que Client et Facture 
implemente I'interface Serializable. (Ce cas est traite dans la premiere partie de cet 
atelier) 

2.2.2.2 : Le developpeur n’a pas I’acces a la source de la classe Client 

Le developpeur de la classe Facture n’a pas Vacces a la source de la classe Client et 
que la classe Client n’implemente pas I'interface Serializable. 

La Solution dans ce cas consiste a creer une classe fille de la classe Client 
(ClientFille) et l'utiliser comme attribut de la classe Facture, la classe ClientFille doit 
implementer I'interface Serializable 
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9. Supprimer le lien d’implementation avec l'interface Serializable a partir de la 
classe Client. Executer la serialisation et remarquer l'impossibilite de serialiser 
les objets Facture si on n’a pas l'acces a la source de la classe Client. 



10. Dans le package « ma.reglement.factures.model», creer la classe ClientFille, classe 
fille de la classe Client. La classe ClientFille doit implementer l'interface 
Serializable. Surcharger le constructeur de la classe ClientFille. 



package ma . reglement . f actures .model ; 
import java . io . Serializable; 

public class ClientFille extends Client implements Serializable 
{ 

public ClientFille (String numTelephone ) { 

super (numTelephone) ; 

} 

} 

11. Modifier la classe Facture en remplacer le type de l'attribut clientFacture par 
ClientFille. Regenerer les getters et les setters et surcharger le constructeur de la 
class e Facture. 

package ma . reglement . f actures .model ; 
import java . io . Serializable; 

public class Facture implements Serializable { 
private String numFacture; 
private ClientFille clientFacture; 
public String getNumFacture ( ) { 

return numFacture; 

} 

public void setNumFacture (String numFacture) { 
this . numFacture = numFacture; 

} 

public ClientFille getClientFacture ( ) { 

return clientFacture; 

} 
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public Facture ( String numFacture, ClientFille 
clientFacture ) { 

super ( ) ; 

this . numFacture = numFacture; 
this . clientFacture = clientFacture; 

} 

public void setClientFacture (ClientFille clientFacture) { 
this . clientFacture = clientFacture; 

} 

} 

12. Modifier la classe SerialisationDuGuichet en utilisant ClientFille a la place de 
Client. Faire l'execution et s’assurer de la reussite de la serialisation. 

public static void main ( String [ ] args) { 

try { 

ClientFille client = new ClientFille (" 0 66150322 8 ") ; 

Facture facture = new Facture ( "FAC0001 " , client); 

FileOutputStream fos = new 
FileOutputStream ( "c : /test . txt " ) ; 

Ob jectOutputStream os = new Ob jectOutputStream (fos) ; 

os .writeObject (facture) ; 

} catch (FileNotFoundException e) { 

e . printStackTrace ( ) ; 

} catch (IOException e) { 

e . printStackTrace ( ) ; 

} 

} 

2.2.2.3 : Le developpeur n’a pas I’acces a la source de la classe Client et que la 
classe Client est finale 
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Le developpeur qui cherche a serialiser les objets de la classe Facture n’a pas l'acces 
a la source de la classe Client et que la classe Client n’implemente pas l'interface 
Serializable et que la classe Client est finale. 

La premiere solution dans ce cas : Si la classe Client est finale, alors le developpeur 
ne peut plus creer des classes filles comme aborde dans le deuxieme cas. Maintenant 
si le contenu de l'objet clientFacture n’est pas important pour le destinataire, ce 
dernier peut etre ignore lors de la serialisation en le declarant transient. 





transient est un mot reserve en java qui permet d'ignorer ia serialisation 
d'un attribut d'un objet. 




13. Mettre 


a classe Client comme final. Remarque que cette classe ne peut plus etre 



etendue. 



public final class Client { 

// Le contenu de la classe Client 

} 

14. Supprimer la classe ClientFille et utiliser la classe Client a sa place. Executer le 
programme de la serialisation et remarquer l'impossibilite de serialiser. 

15. Dans la classe Facture, faire preceder l'attribut clientFacture par transient. 

Exec uter le programme de la serialisation et remarquer. 

package ma . reglement . f actures .model ; 
import java . io . Serializable; 

public class Facture implements Serializable { 
private String numFacture; 
private transient Client clientFacture; 
public String getNumFacture ( ) { 

return numFacture; 

} 

public void setNumFacture (String numFacture) { 
this . numFacture = numFacture; 

} 

public Client getClientFacture ( ) { 

return clientFacture; 

} 

public Facture ( String numFacture, Client clientFacture) { 
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super ( ) ; 

this . numFacture = numFacture; 
this . clientFacture = clientFacture; 

} 

public void setClientFacture (Client clientFacture) { 
this . clientFacture = clientFacture; 

} 

} 



16 . Creer une classe Deserialiserlam contenant la methode main et qui permet de de 
serialiser le fichier precedemment cree. S’assurer que la valeur de l'attribut 
clientFacture est nulle. 



public static void main ( String [ ] args) { 

try { 

FilelnputStream fos = new 
File Input St re am ( "c : /test . txt " ) ; 

Ob jectlnputStream os = new 
Ob jectlnputStream (fos) ; 

Facture f = (Facture) os . readOb ject ( ) ; 

System. out .println ( "La valeur du client est : 

I! 

+ f . getClientFacture ( ) ) ; 

} catch (FileNotFoundException e) { 
e . printStackTrace ( ) ; 

} catch (IOException e) { 
e . printStackTrace ( ) ; 

} catch (ClassNotFoundException e) { 

// TODO Auto-generated catch block 
e . printStackTrace ( ) ; 



La deuxieme solution dans ce cas : Maintenant si le contenu de l’objet clientFacture 
est important pour le destinataire, le developpeur doit faire une serialisation 
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manuelle en introduisant les deux methodes writeObjet(ObjectOutputStrem os) et 
readObject(ObjectInputStrem os) au niveau de la classe Facture. 

17. Garder l'attribut clientFacture declare transient. 

18. Creer les deux methodes writeObjet(ObjectOutputStrem os) et 

readObject(ObjectInputStrem os) dans la classe Facture comme suit : 

package ma . reglement . f actures .model ; 
import java . io . IOExcept ion; 
import java . io . Ob jectlnputStream; 
import java . io . Ob jectOutputStream; 
import java . io . Serializable; 

public class Facture implements Serializable { 
private String numFacture; 
private transient Client clientFacture; 
public String getNumFacture ( ) { 

return numFacture; 

} 

public void setNumFacture (String numFacture) { 
this . numFacture = numFacture; 

} 

public Client getClientFacture ( ) { 

return clientFacture; 

} 

public Facture ( String numFacture, Client clientFacture) { 

super ( ) ; 

this . numFacture = numFacture; 
this . clientFacture = clientFacture; 

} 

public void setClientFacture (Client clientFacture) { 
this . clientFacture = clientFacture; 

} 
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private void writeOb ject (Ob jectOutputStream os) { 

try { 

os . default WriteOb ject ( ) ; 

os . writeOb ject ( clientFacture . getNumTelephone ( ) ) ; 

} catch (IOException e) { 

// TODO Auto-generated catch block 
e . printStackTrace ( ) ; 

} 

} 

private void readOb ject (Ob jectlnputStream is) { 

try { 

is . def aultReadOb ject ( ) ; 

clientFacture= new 
Client ( (String) is . readOb ject ( ) ) ; 

} catch (IOException e) { 

// TODO Auto-generated catch block 

e . printStackTrace ( ) ; 

} catch (ClassNotFoundException e) { 

// TODO Auto-generated catch block 

e . printStackTrace ( ) ; 
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Chapitre 3 : L'acces aux bases de donnees : JDBC 



JDBC est l'acronyme de Java DataBase Connectivity et designe une API definie par Sun 
pour permettre un acces aux bases de donnees avec Java. 

Ce chapitre presente dans plusieurs sections l'utilisation de cette API 

• Presentation des classes de l'API JDBC 

• La connexion a une base de donnees 

• Acceder a la base de donnees 

• Executions de requete SQL 

• La classe ResultSet 

• Exemple complet de mise a jour et de selection sur une table 
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3.1. Presentation des classes de I' API JDBC 

Toutes les classes de JDBC sont dans le package java.sql. II faut done 1'importer dans tous 
les programmes devant utiliser JDBC. 

11 y a 4 classes importantes : DriverManager, Connection, Statement, et ResultSet, 
chacune correspondante a une etape de l'acces aux donnees : 

DriverManager donne la connexion a la base apres avoir charge et configurer le driver 
de la base de donnees. 

Connection realise la connexion et l'authentification a la base de donnees. 

Statement contient la requete SQL et la transmet a la base de donnees et permet de faire 
l’execution. 

ResultSet permet de parcourir les informations retournees par la base de donnees dans 
le cas d'une selection de donnees 

Chacune de ces classes depend de rinstanciation d'un objet de la precedente classe. 

3.2. La connexion a une base de donnees 
3.2.1. Le chargement du pilote 

Pour se connecter a une base en utilisant un driver specifique, la documentation du 
driver fournit le nom de la classe a utiliser. Par exemple, si le nom de la classe est 
Jdbc.DriverXXX, le chargement du driver se fera avec le code suivant : 
Class. forName("Jdbc.DriverXXX"); 

Exemple : Chargement du pilote pour un base PostgreSQL 



Class . forName ( "postgresql .Driver" ) ; 



II n'est pas necessaire de creer une instance de cette classe et de l'enregistrer avec le 
DriverManager car l'appel a Class. forName le fait automatiquement : ce traitement 
charge le pilote et creer une instance de cette classe. 

La methode static forNamef) de la classe Class peut lever l'exception 
Java.lang.ClassNotFoundException. 

3.2.2. L'etablissement de la connection 

Pour se connecter a une base de donnees, il faut instancier un objet de la classe 
Connection en lui precisant sous forme d'URL la base a acceder. 

Exemple : Etablir une connexion sur la base testDB via ODBC 



String DBurl = " jdbc : odbc : testDB" ; 
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con = DriverManager . getConnect ion (DBurl ) ; 



La syntaxe URL peut varier d'un type de base de donnees a l’autre mais elle est toujours 
de la forme : 

protocole:sous_protocole:nom 

« jbdc » designe le protocole est vaut toujours « jdbc ». « odbc » designe le sous protocole 
qui definit le mecanisme de connexion pour un type de bases de donnees. 

Le nom de la base de donnees doit etre celui saisie dans le nom de la source sous ODBC. 
La methode getConnection() peut lever une exception de la classe java.sql.SQLException. 
Le code suivant decrit la creation d'une connection avec un user et un mot de passe : 



Connection con = DriverManager . getConnect ion (url , "myLogin", 
"myPassword" ) ; 



A la place de " myLogin " ; il faut mettre le nom du user qui se connecte a la base et 
mettre son mot de passe a la place de "myPassword " 

3.2.3. L'execution de requetes SQL 



Les requetes d'interrogation SQL sont executees avec les methodes d'un objet Statement 
que l'on obtient a partir d'un objet Connection 



ResultSet resultats = null; 

String requete = "SELECT * FROM client"; 
try { 

Statement stmt = con . createStatement ( ) ; 
resultats = stmt . executeQuery (requete) ; 

} catch (SQLException e) { 

//traitement de 1' exception 
} 



Un objet de la classe Statement permet d'envoyer des requetes SQL a la base. La creation 
d'un objet Statement s'effectue a partir d'une instance de la classe Connection 



Statement stmt = con . createStatement () ; 



Pour une requete de type interrogation (SELECT), la methode a utiliser de la classe 
Statement est executeQuery. Pour des traitements de mise a jour, il faut utiliser la 
methode executeUpdate. Lors de l'appel a la methode d'execution, il est necessaire de lui 
fournir en parametre la requete SQL sous forme de chaine. 

Le resultat d'une requete d'interrogation est renvoye dans un objet de la classe 
ResultSet par la methode executeQueryQ. 
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ResultSet rs = stmt . executeQuery (" SELECT * FROM employe"); 



La methode executeUpdateQ retourne le nombre d'enregistrement qui ont ete mis a jour 



//insertion d'un enregistrement dans la table client 
requete = "INSERT INTO client VALUES (3, 'client 3', 'prenom 

3 ' ) " ; 

try { 

Statement stmt = con . createStatement ( ) ; 
int nbMaj = stmt . executeUpdate (requete) ; 
affiche("nb mise a jour = "+nbMaj); 

} catch (SQLException e) { 
e . printStackTrace () ; 

} 



Lorsque la methode executeUpdate() est utilisee pour executer un traitement de type 
DDL ( Data Defiition Langage : definition de donnees ) comme la creation d'un table, elle 
retourne 0. Si la methode retourne 0, cela peut signifier deux choses : le traitement de 
mise a jour n'a affecte aucun enregistrement ou le traitement concernait un traitement 
de type DDL. 

Si Ton utilise executeQuery pour executer une requete SQL ne contenant pas d'ordre 
SELECT, alors une exception de type SQLException est levee. 



requete = "INSERT INTO client VALUES (4,'client 4','prenom 

4')"; 

try { 

Statement stmt = con . createStatement () ; 

ResultSet resultats = stmt . executeQuery (requete) ; 

} catch (SQLException e) { 
e . printStackTrace () ; 

} 



resultat : 



java . sql . SQLException : No ResultSet was produced 

java . lang . Throwable ( java . lang .String) 

java . lang . Exception ( java . lang .String) 

java . sql . SQLException ( java . lang .String) 

java . sql . ResultSet sun . jdbc . odbc . JdbcOdbcStatement 



Attention : dans ce cas la requete est quand meme effectuee. Dans l'exemple, un nouvel 
enregistrement est cree dans la table. II n'est pas necessaire de definir un objet 
Statement pour chaque ordre SQL : il est possible d'un definir un et de le reutiliser. 

3.2.4. La classe ResultSet 

C'est une classe qui represente une abstraction d'une table qui se compose de plusieurs 
enregistrements constitues de colonnes qui contiennent les donnees. 
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Les principales methodes pour obtenir des donnees sont : 

getlnt(int) : retourne le contenu de la colonne dont le numero est passe en parametre 
sous forme d'entier. 

getlntfString) : retourne le contenu de la colonne dont le nom est passe en parametre 
sous forme d'entier. 

getFloatfint) : retourne le contenu de la colonne dont le numero est passe en parametre 
sous forme de nombre flottant. 

getFloatfString) : retourne le contenu de la colonne dont le nom est passe en parametre 
sous forme de nombre flottant. 

getPate(int) : retourne le contenu de la colonne dont le numero est passe en parametre 
sous forme de date. 

getPate(String) : retourne le contenu de la colonne dont le nom est passe en parametre 
sous forme de date. 

nextQ : se deplace sur le prochain enregistrement : retourne false si la fin est atteinte 
Close 0 ferme le ResultSet 

getMetaPataQ retourne un objet ResultSetMetaData associe au ResultSet. 

La methode getMetaData() retourne un objet de la classe ResultSetMetaData qui permet 
d'obtenir des informations sur le resultat de la requete. Ainsi, le nombre de colonne peut 
etre obtenu grace a la methode getColumnCount de cet objet. 



ResultSetMetaData rsmd; 

rsmd = results . getMetaData () ; 

nbCols = rsmd . getColumnCount () ; 



La methode next() deplace le curseur sur le prochain enregistrement. Le curseur pointe 
initialement juste avant le premier enregistrement : il est necessaire de faire un premier 
appel a la methode next() pour ce placer sur le premier enregistrement. 

Des appels successifs a next permettent de parcourir l'ensemble des enregistrements. 

Elle retourne false lorsqu'il n'y a plus d'enregistrement. II faut toujours proteger le 
parcours d'une table dans un bloc de capture d'exception 

//parcours des donnees retournees 
try { 

ResultSetMetaData rsmd = resultat s . getMetaData () ; 
int nbCols = rsmd . getColumnCount () ; 
boolean encore = resultat s . next () ; 
while (encore) { 

for (int i = 1; i <= nbCols; i++) 

System. out .print (resultats . getString (i) + " "); 
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System . out . print In ( ) ; 
encore = resultat s . next ( ) ; 

} 

re suit at s. close () ; 

} catch (SQLException e) { 
//traitement de 1' exception 
} 



Les methodes getXXX() permettent d'extraire les donnees selon leur type specifiee par 
XXX tel que getString(), getDouble(), getlntegerf), etc ... . II existe deux formes de ces 
methodes : indiquer le numero la colonne en parametre (en commenfant par 1) ou 
indiquer le nom de la colonne en parametre. La premiere methode est plus efficace mais 
peut generer plus d'erreurs a l'execution notamment si la structure de la table evolue. 

Attention : il est important de noter que ce numero de colonne fourni en parametre fait 
reference au numero de colonne de l'objet resultSet (celui correspondant dans l'ordre 
SELECT) et non au numero de colonne de la table. 

La methode getString() permet d'obtenir la valeur d'un champ de n'importe quel type. 

3.2.4. Exemple complet de mise a jour et de selection sur une table 

import java.sql.*; 
public class TestJDBCl { 

private static void affiche (String message) { 

System. out .println (message) ; 

} 

private static void arret (String message) { 

System. err .println (message) ; 

System. exit (99) ; 

} 

public static void main ( java . lang . String [ ] args) { 

Connection con = null; 

ResultSet resultats = null; 

String requete = 

// chargement du pilote 
try { 

Class . forName ("sun. jdbc . odbc . JdbcOdbcD river" ) ; 

} catch (ClassNotFoundExcept ion e) { 

arret (" Impossible de charger le pilote jdbc:odbc"); 

} 

//connection a la base de donnees 

aff iche ( "connection a la base de donnees"); 

try { 

String DBurl = " jdbc : odbc : testDB" ; 

con = DriverManager . getConnect ion (DBurl ) ; 

} catch (SQLException e) { 

arret ( "Connect ion a la base de donnees impossible"); 

} 

//insertion d'un enregistrement dans la table client 
affiche ("creation enregistrement") ; 

requete = "INSERT INTO client VALUES (3,'client 3', 'client 

4 ' ) " ; 
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try { 

Statement stmt = con . createStatement ( ) ; 
int nbMaj = stmt . executeUpdate (requete) ; 
af fiche ( "nb mise a jour = "+nbMaj); 

} catch (SQLException e) { 
e . printStackTrace () ; 

} 

//creation et execution de la requete 

af fiche ( "creation et execution de la requete"); 

requete = "SELECT * FROM client"; 

try { 

Statement stmt = con . createStatement () ; 
resultats = stmt . executeQuery (requete) ; 

} catch (SQLException e) { 

arret ( "Anomalie lors de 1' execution de la requete"); 

} 

//parcours des donnees retournees 

af fiche ( "parcours des donnees retournees"); 

try { 

ResultSetMetaData rsmd = resultats . getMetaData () ; 
int nbCols = rsmd . getColumnCount ( ) ; 
boolean encore = resultats .next () ; 
while (encore) { 

for (int i = 1; i <= nbCols; i++) 

System . out . print (resultats . getString ( i ) + " "); 

System . out . print in ( ) ; 
encore = resultats .next () ; 

} 

re suit at s. close () ; 

} catch (SQLException e) { 
arret (e . getMessage ( ) ) ; 

} 

affiche("fin du programme"); 

System . exit ( 0 ) ; 

} 

} 



Resultat : 



connection a la base de donnees 
creation enregistrement 
nb mise a jour = 1 

creation et execution de la requete 
parcours des donnees retournees 

1.0 client 1 prenom 1 

2.0 client 2 prenom 2 

3.0 client 3 client 4 
fin du programme 
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Chapitre 4 : Java Native Interface JNI 

JNI est l'acronyme de Java Native Interface. C'est une technologie qui permet d'utiliser 
du code natif, notamment C, dans une classe Java. 

L'inconvenient majeur de cette technologie est d'annuler la portabilite du code Java. En 
contre partie cette technologie peut etre tres utile dans plusieurs cas : 

• Pour des raisons de performance 

• Utiliser des composants eprouves deja existants 

La mise en oeuvre de JNI necessite plusieurs etapes : 

• la declaration et l'utilisation de la ou des methodes natives dans la classe Java 

• la compilation de la classe Java 

• la generation du fichier d'en-tete avec l'outil javah 

• l'ecriture du code natif en utilisant entre autres les fichiers d'en-tete fournis par 
le JDK et celui genere precedemment 

• la compilation du code natif sous la forme d'une bibliotheque 

La bibliotheque est done dependante du systeme d'exploitation pour lequel elle est 
developpee : .dll pour les systemes de type Windows, .so pour les systemes de type Unix, 



Ce chapitre contient plusieurs sections : 

• La declaration et l'utilisation d'une methode native 

• La generation du fichier d'en-tete 

• L'ecriture du code natif en C 

• Le passage de parametres et le renvoi d'une valeur (type primitif) 

• Le passage de parametres et le renvoi d'une valeur (type objet) 
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4.1 La declaration et I’util isation d'une methode native 

La declaration dans le code source Java est tres facile puisqu'il suffit de declarer la 
signature de la methode avec le modificateur native. Le modificateur permet au 
compilateur de savoir que cette methode est contenue dans une bibliotheque native. 

II ne doit pas y avoir d'implementation meme pas un corps vide pour une methode 
declaree native. 



class TestJNIl { 

public native void af f icherBon jour ( ) ; 
static { 

System . loadLibrary ( "mabib jni " ) ; 

} 

public static void main (String [ ] args) { 
new TestJNIl ( ) . aff icherBon jour ( ) ; 

} 

} 



Pour pouvoir utiliser une methode native, il faut tout d'abord charger la bibliotheque. 
Pour realiser ce chargement, il faut utiliser la methode statique loadLibrary() de la 
classe system et obligatoirement s'assurer que la bibliotheque est chargee avant le 
premier appel de la methode native. 

Le plus simple pour assurer ce chargement est de le demander dans un morceau de code 
d'initialisation statique de la classe. 



class TestJNIl { 

public native void aff icherBon jour () ; 
static { 

System . loadLibrary ( "mabib jni " ) ; 

} 

} 



Le nom de la bibliotheque fournie en parametre doit etre independant de la plate-forme 
utilisee : il faut preciser le nom de la bibliotheque sans son extension. Le nom sera 
automatiquement adapte selon le systeme d'exploitation sur lequel le code Java est 
execute. 

L'utilisation de la methode native dans le code Java se fait de la meme fafon qu'une 
methode classique. 



class TestJNIl { 

public native void aff icherBon jour () ; 
static { 

System . loadLibrary ( "mabib jni " ) ; 

} 
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public static void main (String [ ] args) { 
new Test JN I 1 ( ) . af f icherBon jour ( ) ; 

} 

} 



4.2 La generation du fichier d'en-tete 

L'outil javah fourni avec le JDK permet de generer un fichier d'en-tete qui va contenir la 
definition dans le langage C des fonctions correspondant aux methodes declarees native 
dans le code source Java. 



Javah utilise le bytecode pour generer le fichier .h. II faut done que la classe Java soit 
prealablement compilee. 



La syntaxe est done : javah -jni nom_fichier_sans_extension 



01 . D : X javaXtest X jni>dir 






02 . 03/12/2003 


14:39 


<DIR> 


. 


03.03/12/2003 


14:39 


<DIR> 


. . 


04 . 03/12/2003 


14 : 39 


230 


TestJNIl . java 


05.2 fichier (s 


) 


230 octets 




06.2 Rep ( s ) 


2 200 772 608 octets libres 




07 . D : \ javaXtest \ jni> javac 


TestJNIl . java 




08 . D : X javaXtest X jni> javah 
0 9 . D : \ javaXtest X jni>dir 


-jni TestJNIl 




1 0 . Repertoire 


de D:\java\test\jni 




11 . 03/12/2003 


14:39 


<DIR> . 




12 . 03/12/2003 


14 : 39 


<DIR> . . 




13.03/12/2003 


14:39 


459 


TestJNIl .class 


14 . 03/12/2003 


14:39 


399 


TestJNIl .h 


15.03/12/2003 


14:39 


230 


TestJNIl . java 


16.3 fichier ( s 


) 1 088 octets 




17.2 Rep (s) 2 


198 208 512 


octets libres 




18 . D : X javaXtest X jni> 







Le fichier TestJNIl.h genere est le suivant : 



01. /* DO NOT EDIT THIS FILE - it is machine generated */ 

02. #include <jni.h> 

03. /* Header for class TestJNIl */ 

04 . 

05. #ifndef _Included_Test JNI 1 

06. #define _Included_Test JNI 1 

07. #ifdef cplusplus 

08 . extern " C " { 

0 9 . #endif 

10 . /* 

11. * Class: TestJNIl 

12. * Method: aff icherBon jour 

13. * Signature: ()V 

14 . */ 

15.JNIEXPORT void JNICALL Java_Test JNI l_aff icherBon j our ( JNIEnv *, jobject); 
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16.#ifdef cplusplus 

17 . } 

18 . #endif 

1 9 . #endif 



Le nom de chaque fonction native respecte le format suivant : 
Java_nomPleinementQualifieDeLaClasse_NomDeLaMethode 

Ce fichier doit etre utilise dans l'implementation du code de la fonction. 

Meme si la methode native est declaree sans parametre, il y a toujours deux parametres 
passes a la fonction native : 

• un pointeur vers une structure JniEnv : cet structure permet d'invoquer certaines 
fonctionnalites natives de JNI grace a un tableau de pointeurs de fonctions 
initialise par la JVM 

• jobject qui est l'objet lui meme : c'est l'equivalent du mot cle this dans le code 
Java 

4.3. L'ecriture du code natif en C 

La bibliotheque contenant la ou les fonctions qui seront appelees doit etre ecrite dans un 
langage (c ou C++) et compilee. 

Pour l'ecriture en C, facilitee par la generation du fichier.h, il est necessaire en plus des 
includes liees au code des fonctions d'inclure deux fichiers d'en-tete : 

• jni.h qui est fourni avec le JDK 

• le fichier .h genere par la commande javah 



01. #include <jni.h> 

02. #include <stdio.h> 

03. #include "TestJNIl.h" 

04. 

05. JNIEXPORT void JNICALL 

06. Java_TestJNIl_afficherBonjour(JNIEnv *env, jobject obj) 

07. { 

08. printf(" BonjourNn "); 

09. return; 

10 . } 



Il faut compiler ce fichier source sous la forme d'un fichier objet .o 



1 . D : \ java\test\ jni>gcc -c -I "C : \ j2sdkl . 4 . 2_02 \include " - 
I "C:\j2sdk 1.4. 2_0 2 \ include 

2 . \win32 " -o Test JNI. o Test JNI. c 
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II faut ensuite definir un fichier .def qui contient la definition des fonctions exportees par 
la bibliotheque 



1 . EXPORTS 

2 . Java_Test JNIl_af f icherBon jour 



II ne reste plus qu'a generer la dll. 



01 . D : \ java\test\ jni>gcc -shared -o mabibjni.dll TestJNI.o Test JNI. def 

02. Warning: resolving _Java_Test JNI l_af f icherBon jour by linking to 
_ J a va_T e s t JN I l_a 

03 . ff icherBon jour @8 

04 . Use-enable-stdcall-f ixup to disable these warnings 

05 . Use-disable-stdcall-f ixup to disable these fixups 

06. 

07 . D : \ java\test\ jni>dir 

08 . Repertoire de D:\java\test\jni 



09.03/12/2003 


16:22 


<DIR> 


. 


10 . 03/12/2003 


16:22 


<DIR> 


. . 


11 . 03/12/2003 


16:22 


12 017 


mabib jni . dll 


12 . 03/12/2003 


15:58 


193 


Test JNI .c 


13.03/12/2003 


16:20 


40 


Test JNI .def 


14 . 03/12/2003 


16:04 


543 


TestJNI.o 


15.03/12/2003 


14 : 39 


459 


TestJNIl . class 


16.03/12/2003 


14 : 39 


399 


TestJNIl .h 


17 . 03/12/2003 


14 : 39 


230 


TestJNIl . java 


18.9 fichier (s 


) 


14 074 octets 




19.2 Rep ( s ) 


2 198 392 


832 octets libres 





20 . 

21 . D : \ java\test\ jni> 



II ne reste plus qu'a executer le code Java dans une machine virtuelle. 



1 . D : \ javaXtest X jni> java TestJNIl 

2 . Bon jour 

3 . D : \ javaXtest \ jni> 



II est interessant de noter que tant que la signature de la methode native ne change pas, 
il est inutile de recompiler la classe Java si la fonction dans la bibliotheque est modifiee 
et recompilee. 
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